QmiCbkLocBestAvailPosInd Struct Reference

Data Fields
struct qmTlvResult	results
ULONG	status
ULONG *	pXid
ULONGLONG *	pLatitude
ULONGLONG *	pLongitude
ULONG *	pHorUncCircular
ULONG *	pAltitudeWrtEllipsoid
ULONG *	pVertUnc
ULONGLONG *	pTimestampUtc
ULONG *	pTimeUnc
ULONG *	pHorUncEllipseSemiMinor
ULONG *	pHorUncEllipseSemiMajor
ULONG *	pHorUncEllipseOrientAzimuth
BYTE *	pHorCirConf
BYTE *	pHorEllpConf
ULONG *	pHorReliability
ULONG *	pSpeedHorizontal
ULONG *	pSpeedUnc
ULONG *	pAltitudeWrtMeanSeaLevel
BYTE *	pVertConfidence
ULONG *	pVertReliability
ULONG *	pSpeedVertical
ULONG *	pSpeedVerticalUnc
ULONG *	pHeading
ULONG *	pHeadingUnc
ULONG *	pMagneticDeviation
ULONG *	pTechnologyMask
precisionDilution *	pPrecisionDilution
gpsTime *	pGpsTime
ULONG *	pTimeSrc
sensorDataUsage *	pSensorDataUsage
svUsedforFix *	pSvUsedforFix

Detailed Description

This structure contains Best Available Position

Parameters

status	Valid values: eQMI_LOC_SUCCESS (0) - Request was completed successfully eQMI_LOC_GENERAL_FAILURE (1) - Request failed because of a general failure eQMI_LOC_UNSUPPORTED (2) - Request failed because it is not supported eQMI_LOC_INVALID_PARAMETER (3) - Request failed because it contained invalid parameters eQMI_LOC_ENGINE_BUSY (4) - Request failed because the engine is busy eQMI_LOC_PHONE_OFFLINE (5) - Request failed because the phone is offline eQMI_LOC_TIMEOUT (6) - Request failed because it timed out eQMI_LOC_CONFIG_NOT_SUPPORTED (7) - Request failed because an undefined configuration was requested eQMI_LOC_INSUFFICIENT_MEMORY (8) - Request failed because the engine could not allocate sufficient memory for the request eQMI_LOC_MAX_GEOFENCE_PROGRAMMED (9) - Request failed because the maximum number of Geofences are already programmed eQMI_LOC_XTRA_VERSION_CHECK_FAILURE (10) - Location service failed because of an XTRA version-based file format check failure
xid	Transaction ID that was specified in the Get Best Available Position request.
pLatitude	Latitude (specified in WGS84 datum) Type - Floating point Units - Degrees Range - -90.0 to 90.0 Positive values indicate northern latitude Negative values indicate southern latitude
pLongitude	Longitude (specified in WGS84 datum) Type - Floating point Units - Degrees Range - -180.0 to 180.0 Positive values indicate eastern latitude Negative values indicate western latitude
pHorUncCircular	Horizontal position uncertainty. Units - Meters
pAltitudeWrtEllipsoid	Altitude With Respect to WGS84 Ellipsoid. Units - Meters Range -500 to 15883
pVertUnc	Vertical uncertainty. Units - Meters
pTimestampUtc	UTC timestamp Units - Milliseconds since Jan. 1, 1970
pTimeUnc	Time uncertainty. Units - Milliseconds
pHorUncEllipseSemiMinor	Semi-minor axis of horizontal elliptical uncertainty. Units - Meters
pHorUncEllipseSemiMajor	Semi-major axis of horizontal elliptical uncertainty. Units: Meters
pHorUncEllipseOrientAzimuth	Elliptical horizontal uncertainty azimuth of orientation. Units - Decimal degrees Range - 0 to 180
pHorCirConf	Horizontal circular uncertainty confidence Units: Precent Range: 0 to 99
pHorEllpConf	Horizontal elliptical uncertainty confidence Units: Precent Range: 0 to 99
pHorReliability	Values 0 - Location reliability is not set. 1 - Location reliability is very low; use it at your own risk 2 - Location reliability is low; little or no cross-checking is possible. 3 - Location reliability is medium; limited cross-check passed 4 - Location reliability is high; strong cross-check passed
pSpeedHorizontal	Horizontal speed. Units - Meters/second
pSpeedUnc	3-D Speed uncertainty. Units - Meters/second.
pAltitudeWrtMeanSeaLevel	Altitude With Respect to Sea Level. Units - Meters
pVertConfidence	Vertical uncertainty confidence. Units - Percentage Range 0 to 99
pVertReliability	Values 0 - Location reliability is not set. 1 - Location reliability is very low; use it at your own risk. 2 - Location reliability is low; little or no cross-checking is possible 3 - Location reliability is medium; limited cross-check passed 4 - Location reliability is high; strong cross-check passed
pSpeedVertical	Vertical speed. Units - Meters/second
pSpeedVerticalUnc	Veritical speed Units: Meters/second
pHeading	Heading. Units - Degree Range 0 to 359.999
pHeadingUnc	Heading uncertainty. Units - Degree Range 0 to 359.999
pMagneticDeviation	Difference between the bearing to true north and the bearing shown on a magnetic compass. The deviation is positive when the magnetic north is east of true north.
pTechnologyMask	Values 0x00000001 - Satellites were used to generate the fix 0x00000002 - Cell towers were used to generate the fix 0x00000004 - Wi-Fi access points were used to generate the fix 0x00000008 - Sensors were used to generate the fix 0x00000010 - Reference Location was used to generate the fix 0x00000020 - Coarse position injected into the location engine was used to generate the fix 0x00000040 - AFLT was used to generate the fix 0x00000080 - GNSS and network-provided measurements were used to generate the fix
-pPrecisionDilution	See precisionDilution for more information
-pGpsTime	See gpsTime for more information
pTimeSrc	Values 0 - Invalid time. 1 - Time is set by the 1X system. 2 - Time is set by WCDMA/GSM time tagging. 3 - Time is set by an external injection. 4 - Time is set after decoding over-the-air GPS navigation data from one GPS satellite. 5 - Time is set after decoding over-the-air GPS navigation data from multiple satellites. 6 - Both time of the week and the GPS week number are known. 7 - Time is set by the position engine after the fix is obtained 8 - Time is set by the position engine after performing SFT, this is done when the clock time uncertainty is large. 9 - Time is set after decoding GLO satellites. 10- Time is set after transforming the GPS to GLO time 11- Time is set by the sleep time tag provided by the WCDMA network. 12- Time is set by the sleep time tag provided by the GSM network 13- Source of the time is unknown 14- Time is derived from the system clock (better known as the slow clock); GNSS time is maintained irrespective of the GNSS receiver state 15- Time is set after decoding QZSS satellites. 16- Time is set after decoding BDS satellites.
-pSensorDataUsage	See sensorDataUsage for more information
-pSvUsedforFix	See svUsedforFix for more information

Field Documentation

ULONG* QmiCbkLocBestAvailPosInd::pAltitudeWrtEllipsoid

ULONG* QmiCbkLocBestAvailPosInd::pAltitudeWrtMeanSeaLevel

gpsTime* QmiCbkLocBestAvailPosInd::pGpsTime

ULONG* QmiCbkLocBestAvailPosInd::pHeading

ULONG* QmiCbkLocBestAvailPosInd::pHeadingUnc

BYTE* QmiCbkLocBestAvailPosInd::pHorCirConf

BYTE* QmiCbkLocBestAvailPosInd::pHorEllpConf

ULONG* QmiCbkLocBestAvailPosInd::pHorReliability

ULONG* QmiCbkLocBestAvailPosInd::pHorUncCircular

ULONG* QmiCbkLocBestAvailPosInd::pHorUncEllipseOrientAzimuth

ULONG* QmiCbkLocBestAvailPosInd::pHorUncEllipseSemiMajor

ULONG* QmiCbkLocBestAvailPosInd::pHorUncEllipseSemiMinor

ULONGLONG* QmiCbkLocBestAvailPosInd::pLatitude

ULONGLONG* QmiCbkLocBestAvailPosInd::pLongitude

ULONG* QmiCbkLocBestAvailPosInd::pMagneticDeviation

precisionDilution* QmiCbkLocBestAvailPosInd::pPrecisionDilution

sensorDataUsage* QmiCbkLocBestAvailPosInd::pSensorDataUsage

ULONG* QmiCbkLocBestAvailPosInd::pSpeedHorizontal

ULONG* QmiCbkLocBestAvailPosInd::pSpeedUnc

ULONG* QmiCbkLocBestAvailPosInd::pSpeedVertical

ULONG* QmiCbkLocBestAvailPosInd::pSpeedVerticalUnc

svUsedforFix* QmiCbkLocBestAvailPosInd::pSvUsedforFix

ULONG* QmiCbkLocBestAvailPosInd::pTechnologyMask

ULONG* QmiCbkLocBestAvailPosInd::pTimeSrc

ULONGLONG* QmiCbkLocBestAvailPosInd::pTimestampUtc

ULONG* QmiCbkLocBestAvailPosInd::pTimeUnc

BYTE* QmiCbkLocBestAvailPosInd::pVertConfidence

ULONG* QmiCbkLocBestAvailPosInd::pVertReliability

ULONG* QmiCbkLocBestAvailPosInd::pVertUnc

ULONG* QmiCbkLocBestAvailPosInd::pXid

struct qmTlvResult QmiCbkLocBestAvailPosInd::results

ULONG QmiCbkLocBestAvailPosInd::status